Geeft als resultaat een Variant (Date) met een datum waaraan een opgegeven tijdsinterval is toegevoegd.
Syntaxis
DateAdd(interval, number, date)
De functie DateAdd heeft de volgende benoemde argumenten:
| Onderdeel | Beschrijving |
|---|---|
| interval | Vereist. Een reeksexpressie die het tijdsinterval aangeeft dat u wilt toevoegen. |
| number | Vereist. Een numerieke expressie die het aantal intervallen aangeeft dat u wilt toevoegen. De waarde kan positief zijn (voor toekomstige datums) of negatief (voor datums in het verleden). |
| date | Vereist. Een Variant (Date) of letterlijke datum die de datum aangeeft waar het interval aan wordt toegevoegd. |
Instellingen
Het argument interval heeft de volgende instellingen:
| Instelling | Beschrijving |
|---|---|
| yyyy | Jaar |
| q | Kwartaal |
| m | Maand |
| y | Dag van het jaar |
| d | Dag |
| w | Dag van de week |
| ww | Week |
| h | Uur |
| m | Minuut |
| s | Seconde |
Notities
U kunt de functie DateAdd gebruiken om een bepaalde tijdsinterval bij een datum op te tellen of van een datum af te trekken. U kunt bijvoorbeeld DateAdd gebruiken om een datum te berekenen die 30 dagen vanaf vandaag of een tijd die 45 minuten vanaf dit moment ligt.
Als u dagen wilt toevoegen aan date kunt u Dag van het jaar ("y"), Dag ("d") of Dag van de week ("w") gebruiken.
De functie DateAdd geeft geen ongeldige datum als resultaat. In het volgende voorbeeld wordt er ΘΘn maand toegevoegd aan 31 januari:
DateAdd("m", 1, "31 jan 95")
In dit geval geeft DateAdd 28 feb 95 als resultaat en niet 31 feb 95. Als date 31 jan 96 is, is het resultaat 29 feb 96 aangezien 1996 een schrikkeljaar is.
Als de berekende datum aan het jaar 100 zou voorafgaan (indien u meer jaren zou aftrekken dan er in date zijn), treedt er een fout op.
Als number geen waarde van het gegevenstype Long is, wordt dit afgerond naar het dichtstbijzijnde gehele getal voordat het wordt geδvalueerd.
Opmerking De notatie van de waarde die als resultaat wordt gegeven voor DateAdd wordt bepaald door de instellingen in het Configuratiescherm, niet door de notatie die is opgegeven in het argument date.
Opmerking Als de instelling van de eigenschap Calendar voor datum Gregoriaans is, moet een Gregoriaanse datum worden opgegeven. Als de kalender Hijri is, moet de opgegeven datum ook Hijri zijn. Als de maandwaarden namen zijn, moet de naam consistent zijn met de huidige instelling van de eigenschap Calendar. Geef numerieke maandwaarden op (korte datumnotatie) om de kans dat maandnamen strijdig zijn met de huidige instelling van de eigenschap Calendar tot een minimum te beperken.